		MPID v1.0 beta
		by Scott Hensel
		Kayala Software

----------------------------------------------------------------

MPID is a program that can name all your mp3s after they have been ripped,
provided you have the CD you ripped them from.

*** What you need: ***

1)      mpid.exe - this program
2)      setid3.exe - optional - for setting the ID3 tags on the mp3s
3)      a cdplayer.ini file
4)      a folder full of generically named mp3s
		( "No Artist - Track 01 - No Title.mp3" etc etc etc )

*** Uses: ***

If you have ever ripped a CD without the benefit of a CDDB server for
automatically naming the tracks for you, this program will come in handy.
What it does is give your generic files some more descriptive names.
Using another program, setid3, you can even set the ID3 tags on the mp3s,
although this is not required and MPID will run fine without it.

*** Alternate uses: ***

MPID can actually be used to rename any type of file.
Just put the following info into a file named "cdplayer.ini"
(then put that "cdplayer.ini" into the same folder with MPID.EXE)

[ABC123]
0=FirstFileName
1=SecondFileName
2=ThirdFileName
[AAA111]
0=FirstFileNameA
1=SecondFileNameA
2=ThirdFileNameA
3=FourthFileNameA

As you can see, the ID (enclosed in brackets) is what separates the
various choices. After that comes a list of file names.
In the program, selecting [AAA111] will allow you to rename a collection
of files to FirstFileNameA, SecondFileNameA, etc...

----------------------------------------------------------------

*** How to use it: ***

----------------------------------------------------------------

Preparation:

Make sure you have a cdplayer.ini file with a few entries in it
	Possible locations:
			c:\winnt\cdplayer.ini
			c:\windows\cdplayer.ini
			.\cdplayer.ini
	In other words, in your system folder OR the current directory

	How to get a cdplayer.ini file:
		Write it by hand - you don't want to do this, trust me.
		Query a CDDB server
			Many CD players, including Winamp, can do this.
			Insert a CD into your drive, and run the CD player.
			Tell the CD player to look up info from a CDDB server
				(make sure you're connected to the internet)
			The CD player will save to %SYSTEMROOT%\cdplayer.ini
				Windows 95/98 : %SYSTEMROOT% == C:\WINDOWS\
				Windows    NT : %SYSTEMROOT% == C:\WINNT\


Make sure that MPID.EXE and SETID3.EXE are in the same directory
		If you don't have it, SETID3.EXE can be downloaded from:
			http://www.t-online.de/home/mschlappa

----------------------------------------------------------------

The next step is to run MPID

	MPID is a DOS text-only program
	If the DOS box disappears too quickly for you to see...
		go to Start menu and choose Run
		Type "command" for Win95/98 or "cmd" for WinNT
		type the drive letter and : followed by return
		type "cd pathname" (pathname is path to MPID's folder)
			eg : cd program files\mpid folder
		type mpid
			now you know why it isn't running
			or you at least have a general idea
			(missing files, invalid permissions, etc)


		example: (assuming mpid.exe is in e:\program files\mpid
			run: "command"
			"e:"
			"cd \program files\mpid"
			"mpid"

----------------------------------------------------------------

Running MPID

MPID will load cdplayer.ini
MPID then will begin prompting you with some questions

MPID Ouput:
	Loading c:\windows\cdplayer.ini
	type the number of the CD you want to select

MPID Input:
	Now you must select your CD
	For example, type 0 or 1 or 2....
	Or...type the exact ID of the CD : [ABC123]

MPID Output:
	0       [ABC123]        ArtistName      CDTitle
		song 1, song 2, song 3, etc

MPID Input:
	Is the CD displayed the one you really want to select?
	Type "yes" or "no" (It checks for the "y" so typing "y" is ok too)

MPID Output:
	What is the name format of your files?

MPID Input:
	Type the general name of your files...

*	For example, if your files are named:
			"No Artist - 01 No Title.mp3"
			"No Artist - 02 No Title.mp3"
			...
			"No Artist - 09 No Title.mp3"
			"No Artist - 10 No Title.mp3"
			"No Artist - 11 No Title.mp3"
		then you must type "Track $.mp3"

*	If your files are named:
			"No Artist - 1 No Title.mp3"
			"No Artist - 2 No Title.mp3"
			...
			"No Artist - 9 No Title.mp3"
			"No Artist - 10 No Title.mp3"
			"No Artist - 11 No Title.mp3"
		then you must type "No Artist - @ No Title.mp3"

*	'$' means use double-digits for file numbers
	'@' means use single-digits if possible

*	Please note: MPID supports the wildcards * and ?
	'*' stands for any group of any number of characters
	'?' stands for any single character
		eg:	 	"No Artist - $ - No Title.mp3"
		is equal to:  	"No*$*.mp3"

MPID Output:
	Batch Files have been written.

MPID Input:
	Type "Q" to quit the program at this point
	(Actually, you can type "Q" almost anytime to quit)
	Or type anything else to start over
	(Starting over will eventually erase the BAT files you just made)

----------------------------------------------------------------

Using the batch files

The output files are stored as RENAMER.BAT and TAGGER.BAT

Put them in the same directory as the mp3s you want to rename
Double click RENAMER.BAT

	If and only if you have already used RENAMER.BAT:
		you can also use TAGGER.BAT if you want to
	Using TAGGER.BAT before RENAMER.BAT will not damage your files
		(It will not do anything useful, either)

What they do:

	RENAMER.BAT renames your generic files to descriptive names
	"Track 01.mp3" becomes
	"(Hole) Live Through This - 06 - Doll Parts.mp3"

	TAGGER.BAT uses the SETID3 program to put tags on your mp3s
	This lets your mp3 player "see" the artist/title of your mp3s
	(You don't have to run TAGGER.BAT if you don't feel like it)

	If you remove SETID3 from the MPID directory or you don't have it,
	you will just get a bunch of error messages when you run TAGGER.BAT

----------------------------------------------------------------

Using command line options...

You may use command line options to answer all or part of the questions
asked by the program, and even avoid the entire interface altogether.

Here is a list of the command line options available:



	/3:"c:\setid3.exe"	path to setid3 executable
	/a:"c:\cdplayer.ini"	path to cdplayer.ini file

	/c:"[ABC123]"		album code to select
	/c:"0"			alternate: album # to select

	/d:"d:\"		directory to read/save files in
	/f:"track*$.mp3"	generic track name
	/i			force no-input mode
	/r:"rename1.bat"	force different file name for renamer.bat
	/s:"c:\windows\"	force different system path
	/t:"tag1.bat"		force different file name for tagger.bat



Please note that if you include more than one of the same flag,
only the last flag will be read.
	example:	mpid /3:"c:\setid3.exe" /3:"c:\set_id3.exe"
			MPID reads only c:\set_id3.exe

The /c option can take the actual album code (beginning with "[")
The /c option also accepts the number of the album (starting at 0)

The /d flag option does not have to end with a backslash.
	example:	/d:"e:\mp3\album1" is OK

The /d flag controls where MPID expects the following files to be:
	setid3.exe
	renamer.bat
	tagger.bat

The /i flag guarantees that you won't have to give any input, even
if the program needs more. It will simply tell you what's wrong and exit.

You only need to put a flag option in quotes if it's more than one word
	example:	/3:"c:\program files\setid3\setid3"
			/d:"c:\my mp3 files"
			/r:"my renamer batch file.bat"

----------------------------------------------------------------

Possible future enhancements:

	# CDDB storage format support in addition to cdplayer.ini
	# CDDB querying from within MPID
		Renaming without inserting the original CD
	# User editing of album info before BAT file creation
DONE	  Command line options to make the interface itself optional
DONE	  Multi-batch file creation -
		for renaming several albums at once
		without overwriting the BAT file every time
DONE	  Wildcards in the track title renaming

----------------------------------------------------------------

*** SETID3 ***


setid3 was written by
Marcus Schlappa
mschlappa@gmx.de

his home page can be found at:
http://home.t-online.de/home/mschlappa/homepage.htm

his setid3 page is located at:
http://home.t-online.de/home/mschlappa/setid3.htm



*** SETID3 INFO ***


situation: 
		- you have created a database for you songs
			(eg: access 97) 
		- you have gigabytes of mp3 files 
		- you want to write your database info into the mp3 files
solution: 
		- let your database application write a batchfile
		- for each file add a line like the following:

	if exist filename.mp3 setid3 /t:"billy jean" /a:"michael jackson" 
			etc ...



He also has made available another program, called Music Store
Music Store allows you to easily organize and search through your mp3s

** Music Store ***

the solution for organizing your music

system requirements

    - windows 95/98/nt 
    - microsoft access 97 
    - winamp v1.92 or higher (freeware) 
    - setID3 v1.11 (freeware) 

----------------------------------------------------------------

Contact information:

	Scott Hensel
	Kayala Software
	mailto: plushpuffin@hotmail.com
	mailto: sphensel@buffalo.edu
	http:   http://www.buffalo.edu/~sphensel
	http:	http://www.buffnet.net/~henselj/mpid.html

	Marcus Schlappa
	mailto:	mschlappa@gmx.de
	http:	http://home.t-online.de/home/mschlappa/homepage.htm